home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / lrange.n < prev    next >
Text File  |  1994-09-20  |  1KB  |  67 lines
  1.  
  2.  
  3.  
  4. lrange(n)             Tcl Built-In Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      lrange - Return one or more adjacent elements from a list
  12.  
  13. SYNOPSIS
  14.      lrange _l_i_s_t _f_i_r_s_t _l_a_s_t
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      _L_i_s_t must be a valid Tcl list.  This command will  return  a
  20.      new   list   consisting  of  elements  _f_i_r_s_t  through  _l_a_s_t,
  21.      inclusive.  _L_a_s_t may be end (or any abbreviation of  it)  to
  22.      refer  to  the  last  element of the list.  If _f_i_r_s_t is less
  23.      than zero, it is treated as if it were  zero.   If  _l_a_s_t  is
  24.      greater than or equal to the number of elements in the list,
  25.      then it is treated as if it were end.  If _f_i_r_s_t  is  greater
  26.      than  _l_a_s_t then an empty string is returned.  Note: ``lrange
  27.      _l_i_s_t _f_i_r_s_t _f_i_r_s_t'' does not always produce the  same  result
  28.      as  ``lindex _l_i_s_t _f_i_r_s_t'' (although it often does for simple
  29.      fields that aren't enclosed in braces);  it  does,  however,
  30.      produce  exactly  the  same  results  as ``list [lindex _l_i_s_t
  31.      _f_i_r_s_t]''
  32.  
  33.  
  34. KEYWORDS
  35.      element, list, range, sublist
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.